home *** CD-ROM | disk | FTP | other *** search
/ Macworld Expo - Develope…Central & Net Innovations / Developer Central and Net Innovators (MacWorld Expo) (January 1999).iso / Developer Central / Metrowerks CodeWarrior / CodeWarrior Pro 4 Release Notes / Welcome_to_CW_Docs < prev   
Encoding:
Text File  |  1998-09-04  |  7.8 KB  |  218 lines  |  [TEXT/CWIE]
  1. Welcome to CodeWarrior Documentation!
  2. Sept 3, 1998
  3.  
  4.  
  5. * I don't want to read this note, I want information fast!
  6.  
  7. Read the Release Notes for the various products! Some information in
  8. the documentation may not be accurate because of last minute changes
  9. to CodeWarrior. Refer to the Release Notes folder for this last
  10. minute information.
  11.  
  12. The QuickStart guide in the root folder of your CodeWarrior CD-ROM
  13. disk will get you started. This on-line version has the latest
  14. information. New users and users who have purchased an update also
  15. get a printed version of this guide.
  16.  
  17. In every manual produced by Metrowerks you'll find the Guide to
  18. CodeWarrior Documentation (on the back page in page-based formats).
  19. It explains how the documentation is structured and points you to the
  20. most commonly-used manuals.
  21.  
  22.  
  23. * I'm new at this, where do I go first?
  24.  
  25. If you are new to programming, look in the CodeWarrior Books folder
  26. for a wide selection of helpful books in electronic format. If you
  27. find one you like, you'll probably want a real paper copy of the
  28. book, it's a lot easier to read and refer to as you learn.
  29.  
  30. If you are new to CodeWarrior, check out these manuals.
  31.  
  32. QuickStart - contains registration, installation, and updating
  33. information.
  34.  
  35. CodeWarrior Core Tutorials - Acrobat files in slide-show format that
  36. walk you through the entire IDE, as well as giving you a hands-on
  37. look at the Project Manager, source-code Editor, and Debugger. More
  38. tutorials are planned for the future.
  39.  
  40. Porting Guide - helps reduce frustration as you port your
  41. programming project from other development environments to
  42. CodeWarrior. This manual offers tips, hints, and guidelines for C,
  43. C++, Pascal, UNIX, MPW, Turbo, and THINK programmers.
  44.  
  45.  
  46. * Which documentation viewer do I use?
  47.  
  48. See the About Doc Formats file for full information on the formats
  49. and viewers available to you for on-line interactive use, and for
  50. printing your own copy of the manuals.
  51.  
  52.  
  53. * What's new and different?
  54.  
  55. All the documentation has been revised to reflect the many new
  56. features of CodeWarrior. However, within this constantly evolving
  57. universe of words, there are some highlights worth special notice.
  58.  
  59. For new CodeWarrior users, you have a first look at the CodeWarrior Core
  60. Tutorials. These Acrobat-based tutorials help you become productive with
  61. CodeWarrior as quickly as possible. To that end, you can take a guided tour
  62. of CodeWarrior, as well as pursue a more detailed examination of the
  63. Project Manager, Editor, and Debugger. In future releases we'll have more
  64. tutorials on other components of the IDE. Your feedback on these early
  65. offerings (as on all our documentation) is welcome and encouraged.
  66.  
  67. The biggest news for this release is two-fold. First, we present the first
  68. appearance of our online help that provides a "How do I..." topic list. We
  69. tried to cover most of the main questions we thought new users might be
  70. asking themselves. In subsequent releases we will be expanding that
  71. coverage to everything under the IDE. So if you find a missing task, please
  72. let us know. In addition, we also include a glossary of common terms used
  73. within the CodeWarrior documentation.
  74.  
  75. We also introduce for the first time our new standard online help system
  76. for all of our host platforms. On Windows we will continue to use WinHelp,
  77. on Solaris we will be using HyperHelp, and on the Mac OS we'll use
  78. QuickHelp. Each of these online help systems allow us to present our help
  79. in a consistant manner no matter which host you are using. Give them a try
  80. and let us know what you think. In the future we hope to convert to HTML
  81. formatted help as the tools become stable enough to use.
  82.  
  83.  
  84. * I want paper manuals!
  85.  
  86. All relevant CodeWarrior documentation for your product is available
  87. in electronic format on the CodeWarrior CD. However, Metrowerks
  88. publishes much of its documentation in printed form.
  89.  
  90. In the past, we put the most popular documentation into two huge
  91. Inside CodeWarrior manuals, one for the Windows-hosted tools and one
  92. for the Mac-hosted tools. These 2,000-page monsters typically had
  93. some of the manuals you wanted, and some that you didn't.
  94.  
  95. Starting with CodeWarrior Professional Release 2, we are reorganizing
  96. our manuals into smaller, more useful books. There will be more books,
  97. but you may need to buy fewer because you can focus on what you need.
  98. The price for each book has gone down as well! Check out the Metrowerks
  99. web site at http://www.metrowerks.com for pricing details.
  100.  
  101. The new book lineup works out like this:
  102.  
  103. Inside CodeWarrior: Core Tools
  104.      - IDE User Guide
  105.      - Debugger User Guide
  106.      - Error Reference
  107.  
  108. Inside CodeWarrior: C/C++ Tools
  109.      - C Compilers Reference
  110.      - MSL C Reference
  111.  
  112. Inside CodeWarrior: Pascal Tools
  113.      - Pascal Compilers Reference
  114.      - Pascal Library Reference
  115.      - Pascal Language Reference
  116.  
  117. Inside CodeWarrior: Targeting Win32 and Java
  118.      - Targeting Win32
  119.      - Targeting Java
  120.  
  121. Inside CodeWarrior: Targeting Mac OS and Java
  122.      - Targeting Mac OS
  123.      - Targeting Java
  124.      - ZoneRanger Manual
  125.  
  126. For PowerPlant documentation, the same volume we used for CodeWarrior
  127. 11 is still in print and current. There will be no reprint for
  128. CodeWarrior Professional 2. You should use the current electronic
  129. version of PowerPlant Advanced Topics if you are looking for
  130. information on the PowerPlant network or internet classes.
  131.  
  132. Inside CodeWarrior: PowerPlant Essentials
  133.     - The PowerPlant Book
  134.     - Constructor for PowerPlant
  135.  
  136. For details on what's inside these and all other Metrowerks manuals,
  137. see the Doc Descriptions file. It provides an overview of all the
  138. documentation, and descriptions of each specific manual.
  139.  
  140.  
  141. * Obsolete Documentation
  142.  
  143. As the technological leading edge moves on, some things become
  144. obsolete. We recognize that even though a particular technology has
  145. been abandoned, you may still want to use it. We continue to provide
  146. documentation on these technologies. The following manual has been
  147. classed as obsolete, although you can still find it in the
  148. documentation directory.
  149.  
  150.  - PowerPlant PowerTalk Reference (Acrobat format)
  151.  
  152. On the other hand, some manuals are replaced or rendered unnecessary.
  153. IN that case, we discontinue the manual complete. Manuals no longer
  154. included on the Reference CD are:
  155.  
  156.  - C++ Library Reference (QuickView format) - referred to the
  157.    obsolete ANSI C++ library
  158.  
  159.  - PowerPlant Core Reference - replaced by PowerPlant Revealed
  160.  
  161.  
  162. * Help! I can't find what I'm looking for.
  163.  
  164. Read the Documentation Description file to see if you can locate the
  165. manual covering your area of interest.
  166.  
  167. Contact Metrowerks Technical Support (support@metrowerks.com). E-mail
  168. forms for reporting bugs, questions, and suggestions are in the
  169. Release Notes folder.
  170.  
  171. For CodeWarrior for Windows 95/NT issues, read or post questions to:
  172.     comp.os.ms-windows.programmer.tools.misc
  173. For CodeWarrior for Mac OS issues, read or post questions to:
  174.     comp.sys.mac.programmer.codewarrior
  175. For Java related issues, read or post questions to:
  176.     comp.lang.java
  177. For PowerPlant related issues, read or post questions to:
  178.     comp.sys.mac.oop.powerplant
  179.  
  180. Metrowerks tech support monitors these and other newsgroups closely.
  181.  
  182.  
  183. * Who is in the Metrowerks documentation team?
  184.  
  185. Metrowerks has a truly remarkable team of people who work hard to
  186. make it all seem clear. The documentation team members devoted to
  187. your satisfaction are:
  188.  
  189.     Caresse Bennett
  190.     David Blache
  191.     Carl Constantine
  192.     Alisa Dean
  193.     Tzu-i 'Kitty' Huang
  194.     Ron Liechty
  195.     Chris Magnuson
  196.     Roopa Malavally
  197.     Todd McDaniel
  198.     Marc Paquette
  199.     John Roseborough
  200.     Derek Saldana
  201.     Roger Wong
  202.     and me, L. Frank Turovich
  203.  
  204. I am proud of this team, and of the top-notch documentation we
  205. produce for you. If you have comments, complaints, or suggestions
  206. about the documentation, you can reach me by e-mail at:
  207.  
  208. wordwarrior@metrowerks.com
  209.  
  210. I want to help you get the most out of CodeWarrior. Let me know what
  211. we've done right, and what you'd like to see done better.
  212.  
  213.  
  214. L. Frank Turovich
  215. Publishing Group Manager
  216. Sept 3, 1998
  217.  
  218.